SetAxisPosition
设定轴的目标位置。
语法
KsError SetAxisPosition(
int Index,
double Position
);
参数
Index:轴的索引。索引以零为起点;别名将影响此参数。
Position:轴的目标位置(使用者单位)。
回传值
如果此函式执行成功,会回传 errNoError
,否则会传回错误码。如需更多有关错误码的资讯,请参阅 KsError 清单。
备注
- 此函式仅可在直接位置 (Direct Position)、PID 速度(PID Velocity) 及 PID 扭矩 (PID Torque) 控制模式中使用,其中此函式为设定轴目标位置的唯一函式。
- 当模数轴启用时,模数值会套用至输入位置。为了避免命令跳跃问题,轴将使用最短路径来更新目标位置。例如,若模数值为 360,且输入位置为 350,则轴会向负方向移动 10°。
范例
复制
KsError nRet = SetAxisPosition(0, 5000);
使用需求
RT | Win32 | |
---|---|---|
最低支援版本 | 4.0 | 4.0 |
标头档 | ksmotion.h | ksmotion.h |
程式库 | KsApi_Rtss.lib | KsApi.lib |
参见